home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / WWW / HSC0916.ZIP / !hsc / docs-source / undocumented.hsc < prev    next >
Text File  |  1997-10-19  |  3KB  |  82 lines
  1. <WEBPAGE chapter="hsc - " title="Undocumented Features"
  2.     QTEXT="But I gotta have it<BR>Watch out for the damage"
  3.     QAUTHOR='Vanessa Paradis, "Gotta Have It"'>
  4.  
  5. This chapter covers some undocumented features of <hsc>.
  6. Most of them are hardly tested, some of them are rather
  7. inconsistent. Also, I did not make much afford to explain
  8. them very well. Try to use them only inside macros, so
  9. you do not have to perform loads of modifications if some
  10. of these are renamed/changed for future versions.
  11.  
  12. <H2>Additional Operators</H2>
  13.  
  14. There are several boolean operators you can use within
  15. <A HREF=":features/expressions.html">expressions</A>:
  16.  
  17. <UL>
  18. <LI><qqc>AND</qqc> - boolean AND
  19. <LI><qqc>OR</qqc> - boolean OR
  20. <LI><qqc>XOR</qqc> - exclusive OR
  21. <LI><qqc><</qqc>, <qqc>></qqc>, <qqc><=</qqc>, <qqc>>=</qqc>, <qqc><></qqc>
  22.     - case insensitive string comparison
  23. </UL>
  24.  
  25. For numeric attributes, you can use operators for integer arithmetic:
  26.  
  27. <UL>
  28. <LI><qqc>+</qqc> - addition. As <qqc>+</qqc> is also used for string concatenation, you will have
  29. to make sure that the type of target attribute is <CODE>NUM</CODE>.
  30. <LI><qqc>-</qqc> - subtraction. As <qqc>-</qqc> is also a legal character in attribute names,
  31. you must enclose it into two white spaces, so that it will not be interpreted as part
  32. of the next or previous word.
  33. <LI><qqc>*</qqc> - multiplication
  34. <LI><qqc>/</qqc> - division
  35. <LI><qqc>MOD</qqc> - modulo
  36. </UL>
  37.  
  38. Currently there are no checks for out-of-range and division-by-zero
  39. etc., so take care. Empty strings count as <qqc>0</qqc>, any text not
  40. consisting only of digits counts as <qqc>1</qqc> (no warnings). This
  41. seems to make sense for auto-casting <CODE>BOOL</CODE> (not sure about
  42. that).
  43.  
  44. <H2>Additional Tags</H2>
  45.  
  46. <H3><TG>$export</TG> - Export Data To Files</H3>
  47.  
  48. This one can be used to export data to a file. Possile attributes:
  49. <DL>
  50. <DT>FILE:string/required
  51. <DD>Name of file where to write output. If the file already exists,
  52.     it will be overwritten without any warning.
  53. <DT>DATA:string/required
  54. <DD>Data to store in the file
  55. <DT>APPEND:bool
  56. <DD>If the output file already exists, the new data will be
  57.     appended with leaving the old contents intact.
  58. </DL>
  59.  
  60. <H2>Options File</H2>
  61.  
  62. <P>On startup, <hsc> will look for an options file, which will be parsed
  63. for command line options <STRONG>before</STRONG> the actual
  64. command line options passed from CLI. Values set in the options
  65. file can be overwritten by command line options later.</P>
  66.  
  67. The format of the options file is easy as can be: it consists of
  68. several lines, with every line containing one single options, and,
  69. if necessary, also a <qqc>=</qqc> and a value. An example options
  70. file could look like this:
  71.  
  72. <PRE>
  73.     FROM=include/stdmacros.hsc
  74.     TO=www:sepp/
  75.     COMPACT
  76.     IGNORE=notes|style
  77. </PRE>
  78.  
  79. The options file always has to be named <FILE>hsc.options</FILE>.
  80.  
  81. </WEBPAGE>
  82.